home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / mkpart.z / mkpart
Encoding:
Text File  |  2001-04-17  |  8.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4. mmmmkkkkppppaaaarrrrtttt((((1111MMMM))))                                                          mmmmkkkkppppaaaarrrrtttt((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mkpart - Partition Configuration Tool for Origin
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      mmmmkkkkppppaaaarrrrtttt [----pppp <_p_a_r_t_i_d> ----mmmm <_b_r_i_c_k> ... [----mmmm <_b_r_i_c_k> ...] ...] ... [----FFFF]
  13.      mmmmkkkkppppaaaarrrrtttt [----iiii] [----FFFF]
  14.      mmmmkkkkppppaaaarrrrtttt [----llll]
  15.      mmmmkkkkppppaaaarrrrtttt [----nnnn]
  16.      mmmmkkkkppppaaaarrrrtttt [----hhhh]
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      mmmmkkkkppppaaaarrrrtttt is the partition administration tool for the Origin 3000 series of
  20.      servers. It provides the System Administrator with capabilities to list
  21.      current partitions, re-configure the system into multiple partitions, and
  22.      to re-initialize, or unpartition, the system.
  23.  
  24.      You must have superuser privilege to use this command. If the system is
  25.      configured as CAP_NO_SUPERUSER, you must have effective capabilities of
  26.      CAP_SHUTDOWN, CAP_DEVICE_MGT and CAP_SYSINFO_MGT.
  27.  
  28.      All the affected partitions have to be rebooted in order to change the
  29.      system to the new partition scheme.
  30.  
  31.      A multi brick Origin 3000 system can be divided into multiple independent
  32.      units for the purposes of booting different kernels on them. These
  33.      systems can be power cycled independently even though they are connected
  34.      by the NUMAlink interconnect. The kernels can detect the presence of
  35.      other partitions by using low level hardware support. A partition is
  36.      identified by its partition id, ppppaaaarrrrttttiiiidddd and a brick is identified by its
  37.      brick id, bbbbrrrriiiicccckkkk. A partition consists of a set of bricks that satisfy the
  38.      following conditions:
  39.  
  40.      The route between any 2 nodes within a partition must be fully within
  41.      that partition and not route through any other partition.
  42.  
  43.      There is a direct route between any 2 partitions and does not route
  44.      through any other partition.
  45.  
  46.      The partition should encompass the entire machine or is a power of 2
  47.      bricks.
  48.  
  49.      For example, in an 8 brick system,
  50.  
  51.      Partition 1 = Bricks 001c10, 001c13, 001c16, 001c21
  52.  
  53.      Partition 2 = Bricks 001c24, 001c29, 001c32, 001c35
  54.  
  55.      After mmmmkkkkppppaaaarrrrtttt has successfully set up the system for the new partition
  56.      config, it asks the user for permission to shutdown all the affected
  57.      partitions. The command automatically shuts down all the affected
  58.      partitions if permission is given by the user.  If not, the new partition
  59.      setup is effective after the next reboot.  After reboot, the system comes
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmkkkkppppaaaarrrrtttt((((1111MMMM))))                                                          mmmmkkkkppppaaaarrrrtttt((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      back to the system maintenance menu with the new partition config.
  75.  
  76.      The mkpart command options are:
  77.  
  78.      ----llll           List all the active partition configurations to standard
  79.                   out.
  80.  
  81.      ----nnnn           Prints the current partition
  82.  
  83.      ----pppp _p_a_r_t_i_d    Specifies the partition id for the new configuration.  The
  84.                   order of the ----mmmm and ----pppp options is significant (see the
  85.                   EXAMPLES section below).
  86.  
  87.      ----mmmm _b_r_i_c_k ... Specifies the brick ids that make up the partition. The ----mmmm
  88.                   option should be specified after a ----pppp option. All the brick
  89.                   ids should be separated by spaces.  The order of the ----mmmm and
  90.                   ----pppp options is significant (see the EXAMPLES section below).
  91.  
  92.      ----iiii           Set the partition id of all bricks to 0000. On the next reboot
  93.                   the system will be coalsced to include all bricks.
  94.  
  95.      ----hhhh           Prints a usage message.
  96.  
  97.      ----FFFF           Forces override of all sanity checks. The command sets up
  98.                   partitioning as given and tries to reboot the system. This
  99.                   option should be used with caution. The user of the command
  100.                   should know about the consequences of wrong usage of this
  101.                   option.
  102.  
  103. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  104.      To partition an 8 brick system into 2 partitions of 4 bricks each:
  105.  
  106.      mmmmkkkkppppaaaarrrrtttt ----pppp 1111 ----mmmm 000000001111cccc11110000 000000001111cccc11113333 000000001111cccc11116666 000000001111cccc22221111 \\\\
  107.             ----pppp 2222 ----mmmm 000000001111cccc22224444 000000001111cccc22229999 000000001111cccc33332222 000000001111cccc33335555
  108.  
  109. NNNNOOOOTTTTEEEESSSS
  110.      The term bbbbrrrriiiicccckkkk in this document refers to a CCCC----bbbbrrrriiiicccckkkk.
  111.  
  112.      The mmmmkkkkppppaaaarrrrtttt command needs the ppppaaaarrrrttttiiiittttiiiioooonnnn, xxxxppppcccc and ccccllll modules to be
  113.      configured into the OS.
  114.  
  115.      The ppppaaaarrrrttttiiiittttiiiioooonnnn iiiidddd of 0000 has a special meaning in the OS. The system
  116.      administrator should avoid the use of ppppaaaarrrrttttiiiittttiiiioooonnnn iiiidddd 0000 when partitioning
  117.      the system. The ppppaaaarrrrttttiiiittttiiiioooonnnn iiiidddd can be any number between 1111 and 66663333, both
  118.      included.
  119.  
  120. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  121.      The mmmmkkkkppppaaaarrrrtttt command does not respond to the interrupt key.  This is
  122.      because the partitioning information may be in a inconsistent state which
  123.      may cause problems on a reboot.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. mmmmkkkkppppaaaarrrrtttt((((1111MMMM))))                                                          mmmmkkkkppppaaaarrrrtttt((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      The mmmmkkkkppppaaaarrrrtttt command performs certain sanity checks on the partition config
  141.      required by the user. It uses the partitioning information currently
  142.      available to do this. Under certain conditions, these checks cannot
  143.      proceed without input from the user.  These are in addition to the three
  144.      checks mentioned previously.
  145.  
  146.      All the bricks must be included in any command line. If a set of modules
  147.      are left out because they will not be affected, the mmmmkkkkppppaaaarrrrtttt command
  148.      automatically includes them and asks the user if it is OK.
  149.  
  150.      Partition ids must be unique and a brick can be included in 1 partition
  151.      only.
  152.  
  153.      The mmmmkkkkppppdddd daemon must be running on all partitions for mmmmkkkkppppaaaarrrrtttt to work. If
  154.      this is not the case, the mmmmkkkkppppaaaarrrrtttt command may terminate with a message to
  155.      the user to check the router connectivity manually.  The user should
  156.      manually check if all the required conditions for partitioning is
  157.      satisfied and use the ----FFFF option to force partitioning.  The command
  158.      appears to take a while for executing. This is because it needs to
  159.      communicate with every daemon in the system many times.  The mmmmkkkkppppdddd daemon
  160.      records some of its messages in the SYSLOG file.
  161.  
  162. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  163.      clshmctl(1), clshmd(1).
  164.  
  165. WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  166.      The mmmmkkkkppppaaaarrrrtttt command is not intended for casual use.  If used incorrectly,
  167.      it can completely freeze all partitions in the system and prevent it from
  168.      even booting the PROM.  Silicon Graphics strongly recommends that this
  169.      command be used with the co-ordination of the System Administrators of
  170.      all the current partitions.
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.